本文档介绍 A1 平台与 Wikipedia 集成的相关接口函数及参数定义。支持获取维基百科页面内容、搜索功能和摘要提取,适用于构建知识库、实现搜索引擎功能、集成到工作流系统等场景。
一、wikipedia_mobile_html
功能说明
获取指定 Wikipedia 页面的移动版 HTML 内容。维基百科的移动端页面内容更加精简,更适合大模型读取和处理。
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
title | String | * | 需要获取的 Wikipedia 页面标题 |
redirect | Boolean | - | 是否允许重定向,默认为 false |
输出参数
| 参数名 | 类型 | 说明 |
|---|
result | String | 获取到的 Wikipedia 页面移动版 HTML 内容 |
二、wikipedia_search
功能说明
在 Wikipedia 上执行搜索操作,返回匹配的页面标题和链接。
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
action | String | * | Wikipedia API 的动作指令,默认为 "opensearch" |
search | String | * | 需要搜索的关键词或短语 |
输出参数
| 参数名 | 类型 | 说明 |
|---|
title | String[] | 搜索到的页面标题列表 |
result | String[] | 与标题对应的页面链接列表 |
三、wikipedia_summary
功能说明
从 Wikipedia 获取指定页面的摘要信息,包括纯文本摘要、HTML 格式摘要和页面链接等。
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
title | String | * | 需要获取摘要的 Wikipedia 页面标题 |
redirect | Boolean | - | 是否允许重定向,默认为 false |
language | String | - | Wikipedia 页面的语言版本,如 en 表示英文、zh 表示中文,默认为 en |
输出参数
| 参数名 | 类型 | 说明 |
|---|
content_urls | Object | 页面在不同设备上的访问链接对象 |
extract | String | 页面的纯文本摘要 |
extract_html | String | 页面的 HTML 格式摘要 |
result | Object | 完整的 API 响应数据对象 |
四、使用示例
4.1 获取移动版 HTML 流程
4.2 搜索页面流程
4.3 获取页面摘要流程
4.4 完整业务场景
五、注意事项
| 项目 | 说明 |
|---|
| 页面标题 | title 参数应使用准确的 Wikipedia 页面标题,建议先通过搜索获取 |
| 语言设置 | 不同语言版本的 Wikipedia 内容可能存在差异 |
| 重定向处理 | 许多 Wikipedia 页面存在重定向,建议启用 redirect 参数以获取正确内容 |
| 内容大小 | 移动版 HTML 更精简,但大型页面内容仍可能较长 |
| 错误处理 | 建议对接口返回结果进行异常捕获和处理 |
如需更多帮助,请参考 Wikipedia API 官方文档 或联系技术支持。